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CHAPTER 1 


GENERAL DESCRIPTION 


1.1 What is KITCHEN PLANNER 


KITCHEN PLANNER is a dinner menu and shopping 
checklist generation program for the APPLE II computer. 

A database with meal items and their ingredients is 
supplied so that you may begin to generate menus and 
shopping lists immediately. The program allows you to 
enter your own meal items and their associated 
ingredients and thereby make the menu truly your own. 

You can store up to 200 dinner meal items and their 
associated ingredients. The program will prepare your 
menu for you. You may make changes to suit your taste. 
These changes are easy to make. You can add, delete, or 
type in whole meals or single items, or swap meals 
between two days. KITCHEN PLANNER can prepare menus that 
are up to fourteen days long. 

Using Chapter 4 of this manual (Getting Acquainted - 
A Tutorial), the computer novice can learn to operate the 
program in less than an hour. When you have become 
familiar with the program's operation, you will be able 
to generate a menu and shopping list in less than five 
minutes! The program features a series of commands 
displayed on the screen which allow you to easily know 
what to do next. 


1.2 Equipment Requirements 


At a minimum, this program requires an APPLE II, 11+ 
or lie with Applesoft in ROM and a single disk drive 
operating under DOS 3.3. 

It is useful, but not necessary, to have a printer. 
The printer interface card must be in slot 1. 
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CHAPTER 2 


THEORY OF OPERATIONS 


2.1 The Menu Generation Process 


KITCHEN PLANNER derives its meal items -from a 
database of meal items < cal led the “Meal I terns List") 
which you can tailor to your own preferences. Meal 
items are classified into seven categories called "Food 
Groups". These are "Protein", "Vegetable", 
"Carbohydrate", “Supplements", "Combination Protein and 
Vegetable" dishes, "Combination Protein and Carbohydrate" 
dishes, and "Complete Heal" dishes. The "Supplements" 
category contains mostly desserts in the Heal I terns List 
originally supplied with this program. 

Each day in your menu can have up to four meal 
items. You can type them in in any order, but, left to 
itself, KITCHEN PLANNER will randomly produce the 
following types of meals, consisting of one meal item 
from each category, with Supplements appearing randomly: 


1) Protein 
Vegetabl e 
Carbohydrate 
< Supp1ement) 


2) Protein and Carbohydrate 
Vege table 

< Supp1emen t) 


3) Protein and Vegetable 4) Complete Meal 
Carbohydrate 

(Supplement) (Supplement) 


Associated with each meal item in the database is a 
"Dinner Frequency Rating." This is a rating from 0 to 

100 which relates to how often a particular dish will 
appear somewhere on the menu when you execute the 
"GENERATE MENU" command from the "Main Selection Menu." 
Very low numbers mean that it will appear seldom and high 
numbers mean that it will appear often. 


2.2 The Shopping Checklist 


Associated with each item in the "Meal I terns List" 
database is a list of ingredients called the "Ingredients 
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List." The more detail in this list, the more complete 
will be your shopping checklist. 

The Shopping List can be viewed or printed only 
after a Menu has been generated and it contains all of 
the ingredients of all of the meal items on your Menu. 

The Shopping List printout groups the food items 
according to the "Store Location Code" which reflects 
generally where the items are located in a supermarket. 
There are 12 "Store Location Codes," as follows? 


1 . 

Meat, Fish, Poultry 

7. 

Dairy, 

Cold Cuts, Del 

2. 

Sauces, Pickles, Mayonnaise 

8. 

Sugar, 

Flour, Sweets 

3. 

Mi seel 1aneous 

9 . 

Canned 

Goods 

4. 

Fruits, Uegetables 

10 . 

Cereal 


5. 

Macaroni, Soup 

11 . 

Bread, 

Cookies 

6 . 

Coffee, Tea, Spices 

12. 

Frozen 

food 


2.3 Updating or Editing the Database 


Meal Items can be added to or deleted from the 
database, and everything about a particular Meal I tern or 
Ingredient can be changed and made more relevant to your 
particular household. You can change the Name, Food 
Group Classification, Dinner Frequency Rating, Notes, and 
Ingredients of any Meal I tern in your database. In 
addition, you can change the Store Location Code for any 
Ingredient in the database. 


2.4 Using KITCHEN PLANNER 


Using the following typical sequence of events you 
can generate your Weekly Menu and Shopping List in less 
than five minutes!! 

Boot the KITCHEN PLANNER Program diskette. After the 
KITCHEN PLANNER Title Page appears and the disk drive 
stops spinning, the "Main Selection Menu" will appear. 
Select and execute the "Generate Menu" selection. 

When your Dinner Menu appears, you will be in the 
"Menu Edit Mode." Change the Menu as you like, and then 
"Exit the Editor" back to the "Main Selection Menu." 
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Next, "Print your Menu" and then "Print your 
Shopping List" on the printer. Cut the printout into two 
1ists. 

Put your "Menu for the Week" in a visible place in 
your kitchen. Take your Shopping Checklist and cross off 
any ingredients you already have in your cupboards and 
add anything else you want. 

Finally, go to the supermarket knowing that you 
haven't forgotton anything! 

You'll be delighted with the time and money you'll 

save ! 
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CHAPTER 3 


OPERATIONS AND COMMANDS SUMMARY 


This summary is intended as a reference guide to the 
Operations and Commands available in the KITCHEN PLANNER 
Program. Each main heading in this chapter refers to a 
selection in the "Main Selection Menu." 

To get to the "Main Selection Menu", boot the Program 
diskette and, after the KITCHEN PLANNER Title Page and 
copyright notice appears and the disk drive stops spinning, 
the "Main Selection Menu" will be displayed. 

Characters enclosed in brackets E 3 refer to single Key 
commands. (Return) means press the Return key. To move the 
cursor (highlighted words) around on any selection menu in 
this program, press the "Right Arrow" key C->] to move down 
the list and the "Left Arrow" key E<-3 to move up the list. 

Any names or numbers typed in (in response to a question) 
can be erased with the "Left Arrow" key. Single character 
commands are usually executed immediat 1y. 


3.1 "GENERATE MENU" 

Execute this to generate a new weekly dinner menu. 

3.1.1 Questions Asked 

3.1.1.1 Enter date (Return) (18 characters max.) 

The date may be expressed any way you like. 

3.1.1.2 Enter Name of the first Menu day 

SUN,MON,TUES,WEDS,THURS,FRI, or SAT (Return) 

3.1.1.3 Enter the number of days long the menu will 
be . 


Enter 1 to 14 (Return). 

Your menu will then be prepared and printed on the 
screen for your approval along with the "Menu Edit 
Commands." The program is now in the "Menu Edit 
Mode." 
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3.1.2 Menu Edit Commands 


When you have moved the cursor to where you want, 
enter the letter in L 3 with no <Return). 

3.1.2.1 Cursor Move Commands 

These commands allow you to quickly move the 
cursor around on your menu. 

[->3 "Right Arrow" 

Moves the cursor one Meal I tern position 

forward (down the Menu). 

[<-3 "Left Arrow" 

Moves the cursor one Meal Item position 

backwards (up the Menu). 

[ . 3 "Period" 

Moves the cursor forward one whole day. 

[ , 3 "Comma" 

Moves the cursor backwards one whole day. 

3.1.2.2 Cursor on the Name of the Day 

These commands affect all four meal item 
positions when the cursor is on the name of 
the day. 

EA3 "Another Meal" 

The program displays a new set of Meal 
Items on the selected day. 

CI3 "Input your Own Meal" 

You enter four Meal Items, each followed 
by a (Return). (19 characters each max.) 
Entering only (Return) will leave that 
meal item position blank. 

CD3 "Delete Whole Meal" 

Causes all meal item positions on the 
selected day to go blank. 

[S3 "Swap Two Days" 

Swaps all the Meal I terns of the selected 
day with another day. Days are numbered 
from 1 up to 14 starting with the first 
day of your menu. 

Enter the number of that day (Return). 
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3.1.2.3 Cursor on the Name of the Meal I tern 

These commands affect only the one meal item 
position at the position of the cursor. 

[A3 ’’Another i tern” 

The program selects another Meal I tern from 
the same "Food Group" as the previous item 
for your approval. 


[13 "Input your Own Item” 

You enter any one Meal I tern (of your own 
choosing) followed by a (Return). <19 
characters max.) 

[D3 "Delete an I tern" 

Causes the Meal I tern position to go blank. 
[S3 "Status Display" 

Displays database status of the selected 
Meal Item including ingredients and notes. 
Press any key to return to your menu. 


3.1.2.4 Cursor Anywhere 


These commands will execute regardless of 
where the cursor is. 


CV3 "View Four More Days" 

Displays next four days of the Menu for 
viewing and/or editing. 

[E3 "Exit the Editor" 

Returns to the "Main Selection Menu.” 

If you have used an Input command and 
have input any items which were not 
previously in the database, the program 
asks the questions "Do you want to update 
your database now?(Y/N)." You do not need 
to press (Return). 

[Y3 Updates the database now. 

Allows ingredients to be available 
for the Shopping List. See "Add A 
Dish" Sec. 3.5.1.2-5 

[N3 Returns to the "Main Selection Menu." 
The Shopping List will not contain 
the ingredients of the new items 
which were input with the [13 
command. 
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3.2 "PRINT MENU 


Allows printing of your previously generated dinner menu. 
Asks the question "Printer or Screen?<P/S)." 

CP3 (Return); Prints Menu on the Printer. 

CS3 (Return): Prints the Menu on the screen 4 days at a 
time. 


3.3 "PRINT OR VIEW SHOPPING LIST" 

Allows printing o-f your Shopping List. 

Asks the question: "Printer or Screen?(P/S)." 

CP3 (Return): Prints the Shopping List on the printer. 

CS3 (Return): Prints the Shopping List on the screen. 

3.4 "RETURN TO LAST MENU" 

Displays previously generated Menu -for further editing, 
(see Menu Edit Commands-Sec. 3.1.2.) 


3.5 "UPDATE OR EDIT DATABASE" 

Upon selection of this module, the user is presented with 
the "Edit Menu Items List" Selection Menu. This module 
allows you to change any parameters of any Meal I tern in 
the database. You should complete your Menu and Shopping 
List printing before adding or deleting meal items. All 
changes made while in this module are added to the 
permanent database on your KITCHEN PLANNER Program 
diskette upon executing the "Return to Main Menu" 
selection. Caution: If the CESC3 key is pressed, then no 
changes will be saved to the disk and you will be 
returned to the "Main Selection Menu." The changed 
database will still be in memory, however. 


3.5.1 "ADD A NEW DISH" 

Allows you to enter a new Meal I tern and all of its 
associated parameters. If you make an error in this 
section after entering a name, you must complete 
this section (through sec. 3.5.1.7) and then change 
your mistake using the "Change Dish Parameters" 
module (Sec. 3.5.2) from the "Edit Menu I terns List" 
Selection Menu. 
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3.5.1.1 Asks for the Name of the Item. 


Enter Name (Return) <19 characters max.) A name can 
contain any characters including spaces. Pressing 
only the (Return) key will return you to the "Edit 
Menu I terns List" Selection Menu. 

a. If Name is already on the Meal Items List as 
spelled (including spaces), a message appears 
briefly on the screen and then control is 
returned to the "Edit Menu I terns List" Selection 
Menu . 

b. If the Name is not already on the Meal I terns 
List as spelled, the program continues to 
3.5.1.2. 


3.5.1.2 Asks for "Food Group" classification. 

This parameter is used by the program to group the 
new meal item and appropriate side dishes into a 
balanced meal (See Chapter 2.) 

Enter a number from 0 to 6 (Return), where: 

0 = Protein 

1 = Vegetable 

2 = Carbohydrate 

3 = Supp1emen ts 

4 = Protein and Vegetable combinations 

5 = Protein and Carbohydrate combinations 

6 = Complete Meals 

3.5.1.3 Asks for "Ingredients" one at a time. 

These are the Ingredients which will appear on your 
Shopping List. You may enter as many Ingredients as 
you like. 

a. Enter Name of the Ingredient (Return) (19 
characters max.) 

b. Asks "Are there more?(Y/N)" 

CY3 (Return): Repeats 3.5.1.3 a&b. 

CN3 (Return): continues to 3.5.1.4 

3.5.1.4 Asks to Rate the present Meal I tern for 
Frequency of appearance in the Menu. 

This parameter determines generally how often this 
Meal Item will appear in your newly generated menus. 

Enter a number from 0 to 100 (Return), where: 
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a. Lower numbers mean the Meal I tern will rarely 
appear in your newly generated Menu, and 

b. Higher numbers mean the Meal Item will appear 
often in your newly generated Menu. 

% ; 

3.5.1.5 Ask -for Notes 

Enter abbreviated name of cookbook and page number 
or whatever. <38 characters max.) 

3.5.1.6 Asks if you would like to enter another dish 

CY3 <Return) Repeats 3.5.1.1-6. 

CN] (Return) 

Return to "Edit Menu I terns List" Selection Menu. 

If new Ingredients have been added to the 
Ingredients List which did not previously exist 
in the database, continue to 3.5.1.7, first, 
then return to the Selection Menu. 

3.5.1.7 "Store Location Code" for new Ingredients. 

If new Ingredients have been added which did not 
previously appear in the Ingredients List database, 
you will be asked to enter a "Store Location Code" 
for each new ingredient. This code allows similar 
items to be grouped together on your Shopping List. 

Enter a number between 1 and 12 (Return) where: 


Meat, Fish, Poultry 

7. 

Dairy, 

Cold Cuts, Deli 

Sauces, Pickles, Mayonnaise 

8. 

Sugar, 

Flour, Sweets 

Mi seel 1aneous 

9. 

Canned 

Goods 

Fruits, Vegetables 

10. 

Cereal 


Macaroni, Soup 

11 . 

Bread, 

Cookies 

Coffee, Tea, Spices 

12. 

Frozen 

food 


3.5.2 "CHANGE DISH PARAMETERS" 

This module allows changes to a Meal Item's parameters 
for Meal I terns which already exist in the Meal I terns 
List Database. 

3.5.2.1 Asks for Name of the Meal I tern you want to 
change: 
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Enter Name (Return). 


a. If Name is not on the List as spelled (including 
spaces), prints a message and then returns to the 
"Edit Menu Items List" Selection Menu. 

b. If Name is on the List, the present status of the 
Meal Item's database parameters are displayed. Press 
any key to continue on to the "Change a Meal I tern" 
Selection Menu. 

3.5.2.2 "The Change A Meal Item" Selection Menu 

a. "Change the Name" 

Asks for the new Name of the Meal Item. 

Enter the new Name (Return). (1? characters max.) 

b. "Add an Ingredient" 

Asks for Ingredients one at a time. 

1. Enter Name of the Ingredient (Return) (19 
characters max.) 

2. Asks "Are there more?(Y/N)“ 

CY3 (Return)s Repeats 1 & 2 
CN3 (Return): continues to 3. 

3. If new ingredients have been added which 
were not previously in the database, enter 
"Store Location Codes", as in Sec. 3.5.1.7. 

c. "Delete An Ingredient" 

Displays a numbered list of Ingredients. Asks for 
the number of the Ingredient you wish to delete. 

Enter the number (Return). 

d. "Change Dinner Rating" 

Asks to Rate the present Meal I tern for Frequency 
of appearance in the Menu. 

Enter a number from 0 to 100 (Return), where! 

1. Lower numbers mean the Meal Item will rarely 
appear in your newly generated Menu, and 

2. Higher numbers mean the Meal I tern will 
appear often in your newly generated Menu. 
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e. “Change Notes” 

Asks for Notes. 

Enter abbreviated name of cookbook and page number 
or whatever (Return). <38 characters max.) 

f. "Change Food Group" 

Asks for "Food Group" classification. 

Enter a number from 0 to 6 (Return), where: 

0 = Protein 

1 = Vege table 

2 = Carbohydrate 

3 = Supp1emen ts 

4 = Protein and Vegetable combinations 

5 = Protein and Carbohydrate combinations 

6 = Complete Meals 

g. "Return to the Editor Menu" 

Returns to the "Edit Meal Items List" Selection 
Menu. 

3.5.3 "Delete A Dish" 

Deletes a Meal I tern and al1 of its parameters from the 
database. Note that ingredients by themselves cannot be 
deleted from the database. 

Asks for the Name of the Item to be deleted from the 
database. 

Enter Name (Return). 

Asks "Are you sure?(Y/N) 

CY3 Deletes the Meal Item. 

CN3 Returns to the "Edit Meal I terns" Selection Menu. 

3.5.4 "Change Store Location Code" 

Allows the Store Location Code for an Ingredient in the 
Ingredients List database to be changed. 

3.5.4.1 Asks for Name of the Ingredient. 

Enter Name (Return). 

3.5.4.2 Prints list of 12 Store Location Codes. 

Asks for number between 1 and 12. 

Enter number (Return). 
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3.5.5 "Return to the Main Menu 


Sorts the new database and stores it on your KITCHEN 
PLANNER Program diskette in drive #1. Returns to the 
Main Selection Menu. This may take a long time if "Food 
Groups" were changed. 

3.6. "LMew or Print Database" 

Allows printing on a printer or the screen of any or all 
Meal Items and their parameters, or Ingredients and their 
Store Location codes. 

3.6.1 Asks "Printer or Screen?(P/S)" 

EP3 <N0 Return) Selects Printer. 

ESI <N0 Return) Selects Screen. 

3.6.2 Asks "Meal I terns List or Ingredients List?(M/I)" 

EMI <N0 Return) Selects Meal I terns List. 

EI3 <N0 Return) Selects Ingredients List. 

3.6.3 Asks "One or AI1?(0/A)" 

E03 <NG Return) Asks for Name. 

Enter Name (Return). Prints Item. 

EA3 <N0 Return) Prints all items on the selected List. 

3.6.4 EESC3 

When you are viewing all of the Meal Items List on the 
screen <S,M,A), the "Escape" key will return you to 
the Main Selection Menu and pressing any other key 
will allow you to view the next Meal Item. 

3.7 "Backup Database" 

Selecting this part of the program allows you to save or 
retrieve your entire KITCHEN PLANNER Database onto a 
normally initialized DOS 3.3 diskette. 

The program asks you to enter: 

ES3 (Return) to Save the database 

ER3 (Return) to Read or Retrieve the database 

3.7.1 Saving your DOS 3.3 Database 

To save your database to a previously initialized DOS 
3.3 diskette, select ES3 and insert your DOS 3.3 
diskette into Drive #1. Press EESC3 to abort and 
return to the Main Menu or Press any other key to 
Save the database to the disk. 
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3.7.2 Reading your DOS 3.3 Database 

To retrieve your database, which you have previously 
saved on a DOS 3.3 diskette, select [R] and insert 
your DOS 3.3 diskette into Drive #1. Press CESC] to 
abort or press any other key to read your database 
into memory. 

To save your database to your KITCHEN PLANNER program 
diskette, simply select the “Update or Edit Database" 
module from the “Main Selection Menu" and then select 
"Return to Main Menu." 

3.7.3 Error Message 

I-f you do not have the correct diskette in the drive, 
you will see the message "Insert Correct Diskette." 

It you see this message, you must either insert the 
correct DOS 3.3 diskette or power down and re--boot 
the program. 

3.7.4 Alternate Databases - Advanced Users 

It you boot up your DOS 3.3 Backup diskette and type 
"CATALOG," you will tind two Text Files named "FLIST" 
and "ZLIST." It you Rename these to, tor example, 
FiLIST" and "ZI LI ST", then the next time you Save a 
database, you will have two separate databases on 
your Backup diskette. The Read/Retrieve tunction 
will always read the tiles which are presently named 
"FLIST" and "ZLIST." In this way you can keep and 
use several databases. Follow the procedure in 
Section 3.7.2 and then re-boot the Program diskette 
betore making a new menu. 

Cautions Be caretul to keep the FLIST/ZLIST pairs 

together. For example, it you mistakenly Rename 
FILIST to FLIST and Z5LIST to ZLIST, the ingredients 
may not be correct or the program may "hang." 
Theretore, always keep an extra backup diskette with 
only the original Database Saved on it. This will 
enable you to always tix the database on your program 
diskette, it it becomes bad. 
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CHAPTER 4 


GETTING ACQUAINTED - A TUTORIAL FOR BEGINNERS 


The following tutorial presents step-by-step 
instructions on how to use this program. You need never have 
touched a computer before to read and use these instructions. 
Knowing how to type is helpful, but hunt-and-peck will do 
just fine. 

To get the most out of this tutorial, read Chapters 1 
and 2, browse through Chapter 3, and then follow the 
instructions in this Chapter while sitting in front of the 
computer. 

Type the examples into the computer exactly as they 
appear in the text and you will be operating the program in a 
very short time. You can't hurt anything and there is plenty 
of time to experiment. If you are adventurous, you may want 
to jump right in and explore the program on your own. That 
is perfectly all right since there are plenty of screen 
messages and Chapter 3 (Operations and Command Summary) to 
help you along. This tutorial is for people who like 
thorough instruction. 


4.1 Getting KITCHEN PLANNER !, up and running" 

Carefully insert your KITCHEN PLANNER Program diskette 
into Disk Drive #1 following the handling instructions 
on the back of the diskette envelope. Then turn the 
power on. This is called "Booting" the diskette. The 
screen will display the KITCHEN PLANNER Title Page and 
Copyright notice and, after the disk drive has finished 
spinning and the red "in use" light has gone off, the 
"Main Selection Menu" will be displayed. 

4.2 The Main Selection Menu 

The "Main Selection Menu" allows you to easily select 
what you want to do. When the "Main Selection Menu" 
first appears on the screen the words "GENERATE MENU" 
are highlighted. The words which are highlighted 
represent the present position of the cursor. The 
cursor can be moved around and its function is to 
select a program module for execution. To move the 
cursor (highlighted words) around on any selection menu 
in this program, press the "Right Arrow" key C->3 to 
move down the list and the "Left Arrow" key C<-3 to 
move up the list. Try the two "Arrow" keys now to get 
the feel of these keys. 
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4.2.1 Generating a Dinner Menu 

When you have gotten the feel of the "Arrow" keys, 
place the cursor on the words "GENERATE MENU" and press 
the <Return) key to execute. 

The program will ask you three questions (see Chapter 
3-sec. 3.1.1). Answer them as follows: 

OCT 31 <Return) 

SUN <Return) 

7 (Return) 

Your menu will now be prepared and the first four days 
of your menu will be displayed on the screen. Press 
the CM3 key to view the last three days of your menu. 
Press CM] again to see the first four days again. CM3 
is one of the "Menu Edit Commands." We will explore 
these more later, but for now press the CE3 key to 
"Exit the Editor" back to the "Main Selection Menu." 

4.2.2 Printing your Menu 

From the "Main Selection Menu", move the cursor so that 
the words "PRINT MENU" are highlighted and press 
(Return). 

You will be asked if you want to use the printer or the 
screen. The choice is yours but if you want to use the 
printer be sure to turn it on first. 

Enter: CP3 (Return) for the printer, or 
CS3 (Return) for the screen. 

If you use the screen, you will see four days at a 
time. Press any key to see four more days. 

When the Menu is finished printing, the screen will 
again display the "Main Selection Menu." 

4.2.3 Printing a Shopping Checklist 

From the "Main Selection Menu", move the cursor so that 
the words "MIEW OR PRINT SHOPPING LIST" are highlighted 
and press (Return). 

You will be asked if you want to use the printer or the 
screen. The choice is yours, but, if you want to use 
the printer, be sure to turn it on first. 

Enter: CP3 (Return) for the printer, or 
CS3 (Return) for the screen. 

If you use the screen, you will see 40 items of the 
Shopping List at a time. If the screen is full, press 
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any key to see the rest of the Shopping List. 

When all of the Ingredients have been printed on the 
Shopping List, the screen will again display the "Main 
Selection Menu." 

If you have used the printer, pull your Menu and 
Shopping List out of the printer and look at it. See 
how easy it is! 

4.2.4 Returning to your Menu 

From the "Main Selection Menu", you may return to your 
previously generated Menu at any time. Move the cursor 
to the words "RETURN TO LAST MENU" and press (Return). 
This allows access to your Menu for further editing 
using the "Edit Menu I terns List" commands. 


4.2.5 Learning to use the "Menu Edit Commands" 

If you have been following along with this tutorial, 
you have already learned two of the "Menu Edit 
Commands." Those were CO] "Uiew Four More Days" and 
CE] "Exit the Editor" back to the "Main Selection 
Menu . " 


The Menu Edit Commands are divided into four 
categories. There are commands which affect all four 
Meal Item positions on the particular day that the 
cursor is on. There are commands which only affect the 
particular Meal Item position that the cursor is on. 
There are commands which do not care where the cursor 
is and, finally, there are the commands which allow you 
to move the cursor around on your Dinner Menu. All of 
these commands are detailed in Chapter 3 sec. 3.1.2. 
Take some time now to review Sec. 3.1.2 while comparing 
it with the "Menu Edit Commands" listed at the bottom 
of your screen. When you are done, return to here to 
continue this tutorial. 


4,2.5.1 "Cursor Move Commands" 

Now that you know what all the "Menu Edit Commands" 
can do, turn to Sec. 3.1,2.1 “Cursor Move Commands" 
and experiment with moving the cursor around on the 
screen until you get the feel of it. When you feel 
comfortable with the "Cursor Move Commands," place 
the cursor on the name of one of the days in your 
menu . 
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4.2.5.2 "Cursor on the Day" Commands 
[A3 "Another Meal" 

With the cursor on the name of a day in your 
Menu, press the CA3 key and you will see a 
whole new meal for that day. 

[13 "Input Your Own Meal" 

With the cursor on a day, press the C13 key to 
type in a whole new meal. It is important 
that you type these words exactly as spelled 
here so that you don't get confused later when 
you "Exit the Editor." Before pressing 
(Return), you may erase what you have typed by 
pressing the [<-3 "Left Arrow" key. After 
each (Return), wait until the blinking cursor 
appears before typing in the next item. 

Types MEAT LQAF< Re turn) 

CHARD< Re turn) 

KICE(Re turn) 

(Return) 

After the fourth (Return) the screen will now 
display the whole menu with the typed in Meal 
Items on that day. 

CD3 "Delete Whole Meal" 

Move the cursor to another day, and press the 

[D3 key. This allows you to go out to dinner 

occasional1y. 

[S3 "Swap Two Days" 

With the cursor on a day, press the [S3 key 
and you will be told the number of the day you 
are on and you will be asked for the number of 

the other day you want to swap with. If you 

have been following along with this tutorial, 
day number 1 is Sunday and day number 7 is 
Saturday. Enter the number of the other day 
you want to swap meals with followed by 
(Return). 

Your new menu will have those day's meals 
swapped. 


18 


4.2.5■ 3 "Cursor- on a Meal I tern" 

These commands affect only the one meal item 
position at the position of the cursor. 

CA3 "Another I tern" 

Move the cursor now to a single Meal I tern and 
press the CA] key. Your new menu will contain 
a new item in that meal item position. 

CI3 "Input your own Item” 

With the cursor on a Meal Item, press the [13 
key and, when the blinking cursor appears, 
type in the word CHARD (Return). Your new 
menu will now contain CHARD in that position. 

ED3 "Delete a Meal Item" 

With the cursor on a Meal Item, press the l D3 
key to delete that meal item from the menu. 

[S3 "Status Display" of the database 

As you learned in chapter 2, each Meal item 
has a number of associated parameters. To 
view the database for a particular Meal Item 
on your menu, press the [S3 key with the 
cursor on that item. The list of ingredients 
appears at the bottom. Press any key to return 
to your Dinner Menu. 

4.2.6 Entering CHARD into the database 

Press the EE3 key to exit the editor back to the "Main 
Selection Menu." If you have been following along with 
this tutorial, the computer will tell you that you have 
entered one new item which was not previously in the 
database. You will be asked if you want to update your 
database now or not. 

Enters EY3 (Return) for "yes" 

You will then be asked a series of questions. These 
questions are detailed in Chapter 3 Sec. 3.5.1.2 to 
3.5.1.7. Read these sections now typing in the answers 
to the questions as you go. Enter CHARD as an 
ingredient when you are asked. 

When you have completed adding the database parameters, 
the program will sort and store the new database and 
then return to the "Main Selection Menu." 
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4.3 Using Chapter 3 

By now you have probably realized that Chapter 3 
contains all the commands and sequences available in 
the KITCHEN PLANNER program. You should study the 
■first three Chapters o-f this manual and then experiment 
with the other selections on the "Main Selection Menu." 
Good Luck and Happy Menu Making! 

4.4 Quitting the program 

When you are ready to quit, simply remove the program 
diskette -from the disk drive, insert it in its 
protective sleeve, and turn off your computer. 




► 
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CHAPTER 5 


TIPS AND TRICKS 


5.1 Saving Memory Space 

When entering Notes keep them as short and abbreviated as 
possible. 


When entering Ingredients keep a printout next to you so 
that you know how each Ingredient is spelled. Potato and 
potatos take up two locations on the Ingredients List. 
Ingredients cannot be deleted from the database once they 
have been entered, except by pressing CESC3 from the "Edit 
Meal Items List" Selection Menu as described in section 
3.5. 


5.2 Tailoring your Shopping List 

When entering the Ingredients of your favorite recipes, 
list the items which you will buy at the supermarket. 

This could be simple like Chow Mein with a Store Location 
Code of 12 (Frozen Foods), or detailed like Chicken, Bean 
Sprouts, Soy Sauce, etc. In a similar way, if you 

usually barbecue your steak, list Charcoal and Lighter 
Fluid as ingredients and they will appear on your Shopping 
Check 1 ist. 

5.3 Meal Items 

Since the program thinks that "SALAD" and " SALAD" (Space 
SALAD) are two different meal items, you can enter two or 
several slightly different entries to permit any item, 
such as salad, to appear on more than one day of your 

computer generated menu. 

If you would like to add a lot of new dishes to the 
database, enter no more than 20 at a time then return to 
the "Main Selection Menu." Re-boot the diskette before 
adding more Meal Items. In any case, after updating the 
database to diskette, it is a good idea to re-boot the 
program diskette before generating a new menu. Otherwise 
your menu may not be balanced. If you see the message 

"LAST ENTRY LOST", the program will automatically re-boot 
after saving the database to the Program diskette. The 
last entry may or may not have been lost. 

Take care when tailoring the database to your personal 

tastes. The quality of your Shopping List depends on it. 
It is suggested that if you are going to make a lot of 
changes to the existing database, that you first print out 
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the whole database on the printer and mark it up with a 
red pen before making any changes. 

5.4 Utility, Breakfast, and Lunch Staples 


Build one or several meal items called "staples" 
<or"uti1ities" or "lunch food") whose Ingredients are your 
staples shopping list. These can be things like cleaners, 


paper towels, cereal, lunch meat, and 
which you want on your shopping list, 
items as "Supplements" and be sure 
your menu. The "Ingredients" will 
shopping list. 


other various items 
Classify these meal 
that they appear on 
then print on your 
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CHAPTER 6 


IN CASE OF TROUBLE 


6.1 Database Problems 

If you get into the "Edit Meal I terns List” mode and you 
think that you have made too many mistakes, you can 
protect your original database on the program diskette by 
pressing the CESC3 key. In any case, always keep a 
back-up copy of your database as described in section 3.7. 

If you change the name of a Meal I tern to one that is 
already on the Meal I terns List, you will end up with two 
on the List with the same name. You should delete one and 
you may have to delete both and re-enter the one you want. 

If you see the message "Out of Memory", the program will 
save the database to the Program diskette and then 
automatically re-boot. Since you have too many meal items 
in your database,you will have to delete the ones that you 
like least. Shortening "Notes" may help also. If this 
occurs, you should consider setting up alternate databases 
as described in section 3.7.4. 

6.2 Powering Down 

Powering down will cause your Menu and Shopping List to be 
lost. If you do not have a printer, you must copy your 
Menu and Shopping List off the screen for future reference 
before turning off your computer. 

If you were editing your database and had not returned to 
the "Main Selection Menu" yet, all your changes will be 
lost if power is lost. 

6.3 If your System Hangs and Nothing Works 

Asking for the printer when there is not a printer 
connected to Slot 1 of your APPLE 3C+ backplane will hang 
the system. 

Other things may cause the system to "Hang." In most 
cases, powering down and rebooting the program diskette 
will fix the problem. 

6.4 Replacement Policy 

If the Program simply will not come up every time you boot 
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from a “power off" state, your diskette may be defective. 
Sav-Soft Products will support you with a 30 day Limited 
Warranty and a 6 Month Limited Warranty. Simply Mail your 
Program Diskette and a written description of the problem 
to Sav-Soft Products. Enclose $10.0Q if the thirty day 
warranty has expired. 

6.5 30 Day Limited Warranty 

Sav-Soft Products warrants this software package to 
operate within all specifications contained in its 
accompanying documentation. Should this program fail to 
meet its specifications during the first 30 days after 
purchase, Sav-Soft Products will correct the failure by 
replacement of the defective diskette with a new diskette, 
upon receipt of the defective diskette and a written 
description of the problem. 

This warranty is null and void in cases where the user has 
attempted to make modifications in the program, physically 
damaged the program diskette, or obtained the product 
through unauthorized or illegal distribution channels. 

No other warranties, other than those expressed, are 
imp1ied. 

6.6 6 Month Limited Warranty 

This warranty extends the 30 day warranty to 6 months from 
the date of purchase and requires a $10.00 fee for 
replacement of the defective diskette. 
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